home *** CD-ROM | disk | FTP | other *** search
/ LOGIC 2000 February / LogicCd--feb.2000-mac-cdr.iso / Apple II / Utilities / Disk2File30 / DOCS.40 next >
Encoding:
Text File  |  1995-10-29  |  5.6 KB  |  227 lines  |  [TEXT/pdos]
  1.  
  2. DSK2FILE, VERSION 3.0
  3.  
  4. RONALD T. KNEUSEL, OCTOBER 1995.
  5. FREEWARE
  6. (RKNEUSEL@POST.ITS.MCW.EDU)
  7.  
  8.  
  9. WHAT IS IT?
  10. -----------
  11.  
  12. DSK2FILE CREATES DISK IMAGES OF
  13. 5.25" DISKS (DOS 3.3 OR PRODOS) FOR
  14. USE WITH APPLE ][ EMULATOR PROGRAMS.
  15.  
  16. DSK2FILE WILL CREATE IMAGES IN DOS
  17. ORDER (.DSK) OR IN PRODOS ORDER
  18. (.PO)  IT DOES NOT MATTER WHAT FORMAT
  19. THE DISK REALLY IS, YOU CAN USE 
  20. EITHER ORDER.  MOST EMULATORS WILL
  21. HANDLE DOS ORDER, SOME WILL ALSO
  22. HANDLE PRODOS ORDER.
  23.  
  24.  
  25. WHAT DO I NEED TO RUN IT?
  26. -------------------------
  27.  
  28. YOU NEED A 5.25" DRIVE, AND ONE OF
  29. THE FOLLOWING:
  30.  
  31. (0) ANOTHER 5.25" DRIVE
  32. (1) 3.5" DRIVE
  33. (2) A HARD DRIVE
  34. (3) A RAM CARD WITH 150K OR MORE
  35.  
  36. DSK2FILE WILL CREATE THE FILE, IT
  37. IS UP TO YOU DO GET THE FILE TO 
  38. THE PC OR MAC.  SEE BELOW FOR
  39. SUGGESTIONS ON HOW TO DO THIS.
  40.  
  41.  
  42. RUNNING DSK2FILE
  43. ----------------
  44.  
  45. DSK2FILE'S MENU HAS TWO CHOICES:
  46.  
  47. (1) 140K DISK -> IMAGE FILE
  48. (2) IMAGE FILE -> 140K DISK
  49.  
  50. AND SOME OPTIONS,
  51.  
  52. (3) SEGMENTED R/W
  53. (4) IMAGE FILE ORDER
  54.  
  55. YOU WILL LIKELY USE (1) THE MOST
  56. OFTEN.  THE SECOND OPTION IS FOR
  57. THOSE WHO MIGHT COME ACROSS AN
  58. IMAGE FILE AND WANT TO PUT THAT
  59. FILE BACK ONTO A DISK AND RUN
  60. IT ON A REAL APPLE ][.
  61.  
  62. USE SEGMENTED READ/WRITE WHEN YOU
  63. HAVE ONLY TWO 5.25" DRIVES.  THIS
  64. WILL OUTPUT THE IMAGE INTO TWO
  65. 70K FILES WHICH WILL FIT ON TWO 
  66. 5.25" FLOPPIES.  USE THE APPROPRIATE
  67. SPLIT/MERGE PROGRAM FOR THE COMPUTER
  68. ON WHICH YOU WILL USE THE IMAGE TO
  69. PIECE IT TOGETHER AGAIN.  THE
  70. PROGRAM SHOULD BE AVAILABLE FROM THE
  71. SAME PLACE YOU GOT THIS PROGRAM. 
  72.  
  73. SELECT IMAGE OPTION, EITHER DOS 3.3
  74. OR PRODOS, FOR THE IMAGE TO CREATE
  75. OR FOR THE IMAGE BEING WRITTEN TO
  76. AN ACTUAL DISK.
  77.  
  78. (1) 140K -> IMAGE FILE
  79.  
  80. DSK2FILE READS ONLY 5.25"
  81. DISKS FROM SLOT 6, DRIVE 1. ENTER THE
  82. COMPLETE PATHNAME FOR THE OUTPUT FILE.
  83. THE IMAGE ORDER AND SEGMENTING WERE
  84. SELECTED VIA THE OPTIONS ON THE MAIN
  85. MENU.
  86.  
  87. INSERT THE DISK WHEN ASKED AND PRESS
  88. RETURN.  THE IMAGE FILE WILL BE CREATED
  89.  
  90.  
  91. (2) IMAGE FILE -> 140K DISK
  92.  
  93.  INSERT A *FORMATTED* 5.25" DISK IN
  94. SLOT 6, DRIVE 1 AND SPECIFY THE
  95. *COMPLETE* PATHNAME OF THE IMAGE FILE
  96. AS ABOVE.  USE THE OPTIONS TO SELECT
  97. THE APPROPRIATE IMAGE ORDER.  USE
  98. PRODOS ORDER FOR .PO IMAGES AND USE
  99. DOS ORDER FOR .DSK OR .DO IMAGE FILES
  100.  
  101.  
  102. WHAT'S WITH THE DOS & PRODOS ORDERS?
  103. ------------------------------------
  104.  
  105. THE APPLE ][ HAS TWO DIFFERENT DISK
  106. OPERATING SYSTEMS: DOS 3.3 AND PRODOS.
  107. (YES, THERE ARE SEVERAL OTHERS, I'M
  108. SIMPLIFYING A BIT, I KNOW :)
  109.  
  110. DOS 3.3 IS THE OLDER AND SLOWER OF THE
  111. TWO AND DEALS IN 256 BYTE SECTORS WITH
  112. 16 SECTORS PER TRACK AND 35 TRACKS PER
  113. 5.25" DISK. PRODOS IS FASTER AND DEALS 
  114. WITH 512 BYTE BLOCKS, 280 PER 5.25" 
  115. DISK.  THEREFORE, EACH PRODOS BLOCK
  116. CORRESPONDS TO TWO SECTORS.  HOWEVER,
  117. THESE ARE NOT NECESSARILY CONTIGUOUS
  118. SECTORS.  PRODOS USES A DIFFERENT 
  119. PHYSICAL SPACING OF WHAT DOS 3.3 WOULD
  120. CALL SECTORS SO THAT READING ALL THE
  121. BLOCKS FROM 0 TO 279 IN ORDER WRITES
  122. THE DATA ON THE DISK TO THE FILE IN
  123. ONE ORDER WHILE USING TRACK 0 TO 34
  124. AND SECTOR 0 TO 15 FOR EACH TRACK WILL
  125. WRITE THE DATA IN A DIFFERENT ORDER.
  126. EITHER WAY, ALL THE DATA WILL BE
  127. WRITTEN, 143360 BYTES TOTAL.
  128.  
  129.  
  130. HOW DOES IT WORK?
  131. -----------------
  132.  
  133. GLAD YOU ASKED! :)
  134.  
  135. DSK2FILE MUST RUN UNDER PRODOS
  136. BECAUSE IT USES PRODOS MLI
  137. COMMANDS TO HANDLE THE DISK FILES.
  138. THIS RELIEVES THE USER FROM CARING
  139. ABOUT THE FILE TYPE OF THE IMAGE
  140. FILE.  IT ALSO MAKES IT MUCH EASIER
  141. THAN USING OLD DOS 3.3 RWTS CALLS.
  142.  
  143. THE DISK IS READ, BLOCK BY BLOCK
  144. AND WRITTEN TO THE OUTPUT FILE IN
  145. 512 BYTE SECTIONS.  IF THE OUTPUT
  146. IS TO BE IN DOS 3.3 ORDER A MAP
  147. IS APPLIED TO THE BLOCK NUMBER TO
  148. TRANSLATE IT INTO A TRACK AND SECTOR
  149. WITH THE APPROPRIATE 256 BYTE SECTION
  150. OF THE BLOCK BEING WRITTEN.  THIS
  151. IS THE EASY PART.
  152.  
  153. WRITING AN IMAGE TO A DISK IS JUST
  154. AS EASY IF THE IMAGE IS IN PRODOS
  155. ORDER.  READ 512 BYTES FROM THE
  156. FILE AND WRITE IT TO BLOCK 0 AND
  157. SO ON.  IF IT IS A DOS 3.3 ORDER
  158. IMAGE FILE LIFE GETS A BIT TRICKY SINCE
  159. WE CAN ONLY READ AND WRITE 512 BYTE 
  160. BLOCKS BUT WE ARE WORKING WITH
  161. HALF A BLOCK AT A TIME.  THE SOLUTION
  162. IS TO READ THE EXISTING BLOCK, THEN
  163. READ THE 256 BYTES FROM THE IMAGE FILE
  164. AND PUT IT IN THE RIGHT HALF OF THE
  165. BLOCK BUFFER.  THEN WRITE THE ENTIRE
  166. BLOCK BACK TO DISK.  THIS IS WHY
  167. GOING FROM A DOS 3.3 IMAGE FILE TO
  168. A DISK TAKES LONGER.
  169.  
  170.  
  171. WHAT DO I DO WITH THE IMAGE FILE?
  172. ---------------------------------
  173.  
  174. THE END GOAL, OF COURSE, IS TO GET THE
  175. FILE TO A PC OR MACINTOSH (OR UNIX BOX)
  176.  
  177. I USE A TERMINAL PROGRAM TO UPLOAD
  178. THE IMAGE FILE (WRITTEN TO MY RAM CARD)
  179. TO A UNIX BOX AND THEN DOWNLOAD IT TO
  180. THE MAC OR PC. (REALLY, I FTP IT SINCE
  181. I HAVE INTERNET ACCESS)  ANOTHER OPTION
  182. IS TO USE A NULL MODEM CABLE AND GO
  183. DIRECTLY TO A PC OR MAC WITH THE IMAGE
  184. FILE.  LASTLY, YOU COULD WRITE THE FILE
  185. TO A 3.5" PRODOS DISK AND USE A MAC TO
  186. READ THE FILE WITH APPLE FILE EXCHANGE.
  187. THEN YOU COULD WRITE THE FILE TO A PC
  188. DISK IF NEED BE.
  189.  
  190. IF THE IMAGE FILE IS IN TWO PIECES USE
  191. THE SPLIT/MERGE PROGRAM FOR YOUR 
  192. COMPUTER (PC, MAC, OR UNIX).  THIS WILL
  193. LET YOU MERGE A SPLIT IMAGE FILE OR
  194. CREATE A SPLIT IMAGE FOR USE WITH AN
  195. APPLE THAT HAS ONLY 5.25" DRIVES.
  196.  
  197.  
  198. IT DOESN'T WORK, NOW WHAT?
  199. --------------------------
  200.  
  201. CONTACT ME AT THE EMAIL ADDRESS ABOVE.
  202. IF YOU START SEEING TWO DIGIT HEX
  203. NUMBERS PLEASE WRITE THEM DOWN TO HELP
  204. ME IN THE DEBUGING.  THESE ARE PRODOS
  205. MLI ERROR CODES.  DSK2FILE WILL NOT
  206. READ COPY PROTECTED DISKS. DISKS WITH
  207. BAD BLOCKS OR SECTORS WILL STILL BE
  208. WRITTEN TO AN IMAGE FILE WITH NONSENSE
  209. IN THE BAD BLOCK OR SECTOR. (ACTUALLY,
  210. IT WILL BE THE DATA THAT WAS IN THE 
  211. LAST BLOCK OR SECTOR SUCCESSFULLY READ)
  212.  
  213.  
  214. I'M IN THE DARK AGES AND DON'T HAVE
  215. EMAIL, HOW DO I CONTACT YOU?
  216. -----------------------------------
  217.  
  218. IF YOU FEEL A COMPELLING NEED YOU
  219. CAN TRY SNAIL MAIL:
  220.  
  221. RON KNEUSEL
  222. 8725 W BURDICK AVE
  223. MILWAUKEE, WI 53227 USA
  224.  
  225. AMDG
  226.  
  227.